package com.ruoyi.system.mapper;

import java.util.Date;
import java.util.List;
import com.ruoyi.system.domain.VoucherOperationLog;
import org.apache.ibatis.annotations.Param;

/**
 * 代金券操作记录，记录代金券全生命周期的操作日志及变更追踪Mapper接口
 *
 * @author ruoyi
 * @date 2025-05-22
 */
public interface VoucherOperationLogMapper
{
    /**
     * 通过id查询代金券操作记录
     *
     * @param id 代金券操作记录，记录代金券全生命周期的操作日志及变更追踪主键
     * @return 代金券操作记录，记录代金券全生命周期的操作日志及变更追踪
     */
    public VoucherOperationLog selectVoucherOperationLogById(Long id);

    /**
     * 通过条件查询代金券操作记录列表
     *
     * @param operationType,voucherCode,operationStartTime,operationEndTime 操作类型，代金券编码，操作开始时间，操作结束时间
     * @return 代金券操作记录，记录代金券全生命周期的操作日志及变更追踪集合
     */
    public List<VoucherOperationLog> selectVoucherOperationLogListByConditions(@Param("operationType") String operationType, @Param("voucherCode") String voucherCode, @Param("operationStartTime") Date operationStartTime, @Param("operationEndTime") Date operationEndTime);

    /**
     * 新增代金券操作记录
     *
     * @param voucherOperationLog 代金券操作记录，记录代金券全生命周期的操作日志及变更追踪
     * @return 结果
     */
    public int insertVoucherOperationLog(VoucherOperationLog voucherOperationLog);

    /**
     * 修改代金券操作记录
     *
     * @param voucherOperationLog 代金券操作记录，记录代金券全生命周期的操作日志及变更追踪
     * @return 结果
     */
    public int updateVoucherOperationLog(VoucherOperationLog voucherOperationLog);

    /**
     * 通过id批量删除代金券操作记录信息
     *
     * @param id 代金券操作记录，记录代金券全生命周期的操作日志及变更追踪主键
     * @return 结果
     */
    public int deleteVoucherOperationLogById(Long id);

    /**
     * 通过id批量删除代金券操作记录信息
     *
     * @param ids 需要删除的数据主键集合
     * @return 结果
     */
    public int deleteVoucherOperationLogByIds(Long[] ids);
}
